home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / qrt.lzh / qrt_st.txt < prev    next >
Text File  |  1985-11-19  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                        QRT/ST Machine Specific Reference
  7.                                 Robert Barnhardt
  8.  
  9.  
  10.        COPYRIGHT INFORMATION
  11.  
  12.        QRT source and executable is Copyright 1988 Steve Koren.   It  may
  13.        be freely copied,  modified,  and distributed under the  following
  14.        conditions:
  15.  
  16.          1) Notice of any changes is posted and distributed with
  17.             subsequent versions.
  18.          2) Neither the source nor executable is sold for profit.
  19.          3) This message is distributed unmodified with the source and
  20.             executable.
  21.  
  22.        Any images created with QRT are yours to do with as you wish.
  23.  
  24.  
  25.        INTRODUCTION
  26.  
  27.        The  QRT ray tracer was ported from Steve Koren's  original  Amiga
  28.        sources,   and  thus  it  should  be  100%  compatible,   the  few
  29.        exceptions being noted in the remainder of this document.
  30.  
  31.        The general usage of QRT is a simple, 3-step process:
  32.  
  33.          o  Create a scene description file (.QRT), in accordance with
  34.             the accompanying QRT documentation.
  35.          o  Render the scene with QRT, to produce a graphical output
  36.             image file (.RAW).
  37.          o  Convert the image to a format displayable on your equipment
  38.             (for the ST, Spectrum 512 format).
  39.  
  40.  
  41.        QRT/ST USAGE
  42.  
  43.        The command line of QRT/ST differs slightly from that of the Amiga
  44.        version.   Because  of the extremely short TTP line,  the  command
  45.        line  keywords  -aspect,  -foclen,  -xres,  and  -yres  have  been
  46.        shortened to -a,  -f, -x, and -y, respectively.
  47.  
  48.          Usage:  QRT [-x +i] [-y +i] [-a +f] [-f +f] filename.qrt
  49.                  -x specifies the x resolution of the output file.
  50.                  -y     "      "  y     "      "   "    "     "  .
  51.                  -a     "      "  aspect ratio of the output file.
  52.                  -f     "      "  focal length of the observer.
  53.            ( Where +i and +f are positive integer and floating point. )
  54.  
  55.        Command line options will override information in the  input file.
  56.        If you do not specify an input file,  QRT/ST  will wait for you to
  57.        enter a description by hand: to abort, press Control-C;  to signal
  58.        that your description is complete, press Control-Z.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.        QRT Ray Tracer                Page 1                  ST Reference
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.        QRT/ST INPUT FILES
  73.  
  74.        All keywords supported in the current release (1.4) of QRT for the
  75.        Amiga are supported,  with the exception of DITHER;  its inclusion
  76.        or  exclusion will be completely ignored,  generating  no  errors.
  77.        With an output resolution of 16 million colours, dithering (in the
  78.        source)  is redundant;  the rendering of the output image is  left
  79.        wholly to the post-processor.
  80.  
  81.        In addition to the FIRST_SCAN and LAST_SCAN keywords,  FIRST_X and
  82.        LAST_X have been added,  so that you can select any section of  an
  83.        image  to  ray  trace.  For example,  you might wish  to  get  the
  84.        lighting correct on a certain object; with the above keywords, you
  85.        can  'single  out' that object,  making for  faster  (preliminary)
  86.        traces, until you get the lighting correct.
  87.  
  88.        Not noted in the accompanying (original) QRT documentation are the
  89.        following DEFAULT parameters: x_res, y_res, and aspect, which work
  90.        exactly as you'd expect them to.
  91.  
  92.  
  93.        QRT/ST OUTPUT FILES
  94.  
  95.        QRT/ST  outputs  a non-format that I call 'RAW',  for  lack  of  a
  96.        better name.  It has an extremely simple format, as follows:
  97.  
  98.           "<xres> <yres>[lf]"   The X and Y resolution of  the  file,  as
  99.                                 ASCII strings seperated by a  space,  and
  100.                                 terminated with a linefeed (chr$(10)).
  101.           <r><g><b>             One byte each of red, green, and blue for
  102.                                 each pixel.   The bytes are in the  range
  103.                                 of  0  to 255,  proving a 24  bit  colour
  104.                                 resolution (16 million colours).
  105.                                 
  106.        The post-processor provided with QRT/ST,  RAW2SPEC,  uses advanced
  107.        dithering  methods to reduce the 16 million colour output  to  512
  108.        colours.  For more information, read RAW2SPEC's documentation.
  109.  
  110.  
  111.        IMPORTANT NOTE
  112.  
  113.        As  of 03/08/91,  I've not found an address of any sort for  Steve
  114.        Koren,  the author of QRT.  If you know of any way to contact him,
  115.        let  me know,  because I'd like to notify him of this  conversion.
  116.        As usual in this sort of thing, QRT/ST is yours to use at your own
  117.        discretion,  and in the event of any accidental damages, neither I
  118.        nor Steve Koren may be held responsible.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.        QRT Ray Tracer                Page 2                  ST Reference
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.        UNIMPORTANT NOTES
  139.  
  140.        I  chose QRT to port (as opposed to MTV or DKB) because I felt  it
  141.        represented the best compromise of speed and features.   You won't
  142.        be  creating photorealistic images with QRT/ST (and if you  could,
  143.        the  ST certainly couldn't display them),  but you can  make  some
  144.        incredible pictures, with a bit of time and effort.
  145.  
  146.        I won't release the Laser C source for QRT/ST,  so don't ask;  not
  147.        only is it not mine to give,  it has become unnecessarily  cryptic
  148.        (partly  Megamax,  partly  me).   If you want the  original  Amiga
  149.        source,  look on a few Amiga bulletin boards; that's where I found
  150.        it, at any rate.
  151.  
  152.        If you create any images with QRT/ST and plan to upload them,  you
  153.        might consider uploading the .QRT source as well,  as there  seems
  154.        to  be a dearth of .QRT source in the public domain (those that  I
  155.        included in the QRT/ST archive are all that I could find).
  156.  
  157.  
  158.        BUGS...
  159.  
  160.        If you find any,  please report them to me,  rather than to  Steve
  161.        Koren;  they'll most likely be my fault,  and if they're not, I'll
  162.        try to pass them on (if I ever find him).
  163.  
  164.        I can be reached at the following:
  165.  
  166.        Robert Barnhardt                         CompuServe: 73707,533
  167.        869 Garrison Road                        GEnie     : R.BARNHARDT1
  168.        Fort Erie, Ontario
  169.        CANADA   L2A 1N6
  170.  
  171.  
  172.  
  173.        POST-SCRIPT
  174.  
  175.        As of this writing, 04/08/91 02:00, I've just finished hardwiring
  176.        my  floppy drive directly to my  520.  At about 22:00  yesterday,
  177.        the drive ceased  to respond to the constant  cable-jiggling that
  178.        had previously kept it alive (if just barely).
  179.  
  180.        If this  setup goes on me,  I'll have no way to call  the on-line
  181.        services mentioned above;  if you leave mail to me  and I haven't
  182.        replied  within a month,  you can safely  assume that I  won't be
  183.        responding.   At any rate,  you can always reach me  at the above
  184.        (real-world) address.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.        QRT Ray Tracer                Page 3                  ST Reference
  198.